home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr37 / host.zip / HOST.DOC
Text File  |  1993-01-01  |  10KB  |  281 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                    ▌█▌     ▌█▌ ▌████████▌ ▌███████▌ ▌█████████
  15.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌ ▌█▌           ▌█▌
  16.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌ ▌█▌           ▌█▌
  17.                    ▌█▌█████▌█▌ ▌█▌    ▌█▌ ▌█▌▌████▌     ▌█▌
  18.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌       ▌█▌     ▌█▌
  19.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌       ▌█▌     ▌█▌
  20.                    ▌█▌     ▌█▌ ▌████████▌ ▌███████▌     ▌█▌
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                               By  Tsung Hu
  29.  
  30.  
  31.                            White River Software
  32.  
  33.  
  34.  
  35.  
  36.   Introduction
  37.   ──────────────────────────────────────────────────────────────────────────
  38.  
  39.       Telemate host mode is written with its script language and can be
  40.       modified freely with no royalty. In Telemate 3.00, there are many
  41.       useful commands, such as file and string handling, which make the
  42.       host script easier to be written.
  43.  
  44.       The following are the host-related files:
  45.  
  46.           HCONFIG.SCR  - Host configuration script
  47.           HCONFIG.TMS  - Compiled script, C>TMS HCONFIG
  48.           HOST.SCR     - Host mode script
  49.           HOST.TMS     - Compiled script, C>TMS HOST
  50.  
  51.           HCONFIG.HST  - Configuration file  (created after first run)
  52.           HUSER.HST    - User information   (created after first run)
  53.           HWELCOME.HST - Welcome message
  54.           HNOTICE.HST  - Notice or bulletin
  55.           HMENU.HST    - Main menu
  56.           HPROT.HST    - Protocol menu
  57.           BGOODBYE.HST - Goodbye message
  58.  
  59.           HSHELL.BAT   - [S]hell batch file  (created during configuration)
  60.           HLOCAL.BAT   - [R]un local program
  61.           HREMOTE.BAT  - [R]un remote program
  62.           HOST.DIR     - [F]ile directory file (run-time temporary file)
  63.  
  64.  
  65.   To Install The Host Mode
  66.   ──────────────────────────────────────────────────────────────────────────
  67.  
  68.       . Set the modem answer string to "~~~+++~~~AT S0=1^M" under the
  69.         Options/Communication dialog
  70.  
  71.       . Run the HCONFIG.SCR by passing [Alt S]. HCONFIG will ask you which
  72.         COM port you are using. If it is COM1 or COM2, it will generate
  73.         the HSHELL.BAT batch file with the following content,
  74.           CTTY COM1
  75.           COMMAND
  76.           CTTY CON
  77.           EXIT
  78.         supposed the modem is in COM1. This batch file allows you to shell
  79.         to DOS with the [S]hell command.
  80.  
  81.         Then it will display the menu
  82.  
  83.           A: New user level     : 1
  84.           B: Sysop level        : 2
  85.           C: Detect baud rate   : ON
  86.           D: Initial baud rate  : 2400
  87.           E: Yell time          : 3 seconds
  88.           F: Yell sound         : 1 seconds
  89.           G: Host directory     : \TM
  90.           H: Download directory : \TM
  91.           I: Upload directory   : \TM
  92.           J: Close system       : OFF
  93.  
  94.           S: Save configuration and run host mode
  95.           Q: Abort configration
  96.  
  97.  
  98.  
  99.         Telemate's host uses two user levels. Level 2 (the sysop level)
  100.         can use the [S]hell, [R]un remote program and [Z] shut down
  101.         commands while level 1 cannot.
  102.  
  103.         As an open system, new user can join the system freely. Each of
  104.         them have his own password. If the <Close system> option is
  105.         turned on, new user is not allowed until the sysop adds his name
  106.         and password to the user file. (See Format Of The User File.)
  107.  
  108.         Some modems can lock the COM port at a certain baud rate. For
  109.         example, a 2400 baud MNP modem can lock at 4800 or 9600 baud with
  110.         the "AT &B1" command. For these modems, the <Detect baud rate>
  111.         option should be turned off.
  112.  
  113.         <Initial baud rate> should be the highest possible baud rate of your
  114.         modem.
  115.  
  116.         <Yell time> and <Yell sound> are the amount of time, in second, that
  117.         the alarm appears and yells when the [C]hat command is issued. To
  118.         disable the [C]hat command, you can set the <Yell time> to 0.
  119.  
  120.         <Host directory> is the directory containing all the H*.HST and
  121.         H*.BAT files, they  are the bulletin, the menu and the batch file
  122.         for shelling to DOS.
  123.  
  124.         <Download directory> is the host download directory. The [F]ile,
  125.         [T]ype and [D]ownload commands can only access files in this
  126.         directory.
  127.  
  128.         <Upload directory> is the host upload directory. All upload will
  129.         go to this directory.
  130.  
  131.         After setting up these parameters, you can press 'S' to save the
  132.         configuration and it will chain to the host script automatically.
  133.  
  134.       . However, installation is not completed yet. To make full use of the
  135.         host script, you should also modify the HSHELL.BAT, HLOCAL.BAT and
  136.         HREMOTE.BAT batch file.
  137.  
  138.         HSHELL.BAT will be executed when the [S]hell command is issued.
  139.         Although it is already created by the HCONFIG.SCR, the batch file
  140.         does not monitor carrier signal. That means the computer will hang
  141.         up when the remote user drop carrier. You should use a third-party
  142.         product such as WATCHDOG or DOORWAY for maximum security.
  143.         Note: In local mode, HOST will shell to DOS directly and will not
  144.         use this batch file.
  145.  
  146.         HREMOTE.BAT will be executed when the [R]un remote program command
  147.         is issued by a caller. This program can be a game or an BBS editor.
  148.  
  149.         HLOCAL.BAT is similar to HREMOTE.BAT but it is executed when the [R]
  150.         command is issued in local mode. You may use the same program but
  151.         different options or use a completely different program in this
  152.         batch file.
  153.  
  154.         Of course, you should customize your own welcome message and
  155.         bulletin. A warm welcome will make the user feel much better. If
  156.         you don't have any bulletin, you may delete the HNOTICE.HST.
  157.  
  158.  
  159.  
  160.   Running The Host Mode
  161.   ──────────────────────────────────────────────────────────────────────────
  162.  
  163.       To run the HOST.SCR, you could press [Alt S] while you are in
  164.       Telemate. Or type
  165.           C>TM HOST
  166.       while you are in DOS command line.
  167.  
  168.       When the host mode begin, you could press
  169.           'L'     for local mode
  170.           'C'     for configuration (run HCONFIG.SCR)
  171.           [Esc]   to terminate host
  172.           [Alt H] to temrinate the user (hang up the phone)
  173.  
  174.       When a call is encounter, the user will be asked for his name and
  175.       password. The name and password must be or longer than 4 characters.
  176.       After that, the user can choose a command from the menu.
  177.  
  178.       Most of the users should have experiences with different types of
  179.       BBSs. But they all have the commands
  180.  
  181.           [F]ile directory
  182.           [U]pload a file
  183.           [D]ownload a file
  184.           [T]ype a file
  185.           [C]hat with sysop
  186.           [X]pert mode
  187.           [G]oodbye
  188.  
  189.       The [F]ile command will shell to DOS and execute the DOS command
  190.           DIR >\HOST.DIR
  191.       which store the file list into a file. Then HOST.SCR will display
  192.       the file. So don't worry when it shell to DOS, it is just a [F]ile
  193.       command.
  194.  
  195.       When the user issues the [C]hat command, the alarm will be pop-up.
  196.       Sysop should press
  197.           [Enter] to accept
  198.           [Esc] to deny
  199.       If [Enter] is pressed, HOST.SCR will begin a chat mode. The sysop
  200.       should press [Esc] to terminate the chat mode.
  201.  
  202.       There are three commands provided for sysop. They are
  203.  
  204.           [S]hell to DOS
  205.           [R]un remote program
  206.           [Z] shut down
  207.  
  208.       The [S]hell command will jump to DOS directly in local mode; and run
  209.       the HSHELL.BAT to shell to DOS if it is a remote call.
  210.  
  211.       The [R]un command will run HLOCAL.BAT in local mode; and run
  212.       HREMOTE.BAT in remote mode.
  213.  
  214.       The [Z] shut down command should be issued only if you don't need the
  215.       host mode any more. It will ask you 'Are you sure ?'. If you said
  216.       'Y'es, the call will be disconnected and will not answer any more
  217.       callers.
  218.  
  219.  
  220.  
  221.   Format Of The User File   (HUSER.HST)
  222.   ──────────────────────────────────────────────────────────────────────────
  223.  
  224.       A user's name, password and access level are stored in the file
  225.       HUSER.HST. The format is
  226.  
  227.           first last;password#<level>
  228.  
  229.       where <level> is 1 or 2. For example, my record will look like
  230.  
  231.           first last;mypass#1
  232.  
  233.       To raise a user's access level, you can use a text editor to
  234.       change the 1 to 2. After that, the record will look like
  235.  
  236.           first last;mypass#2
  237.  
  238.       There may be several records in the file, they all have the same
  239.       format.
  240.  
  241.       If the <Close system> option is turned on, the sysop must add the
  242.       user's name and password manually.
  243.  
  244.  
  245.   Further Improvement
  246.   ──────────────────────────────────────────────────────────────────────────
  247.  
  248.       There are a lot of space for improvements. Here are a few
  249.       suggestions:
  250.  
  251.       . More access levels and different menu for different level.
  252.  
  253.       . Usage log: If you would like to keep track of a user's activities,
  254.         you could add
  255.           USAGE "User attempts to shell to DOS"
  256.         etc.
  257.  
  258.       . Inactive timeout: This can be done by
  259.           IF NOT LOCAL
  260.              WHENIDLE 600,"^*"
  261.           ENDIF
  262.         which send the modem hangup string if there is no activity through
  263.         the COM port in 10 minutes.
  264.  
  265.       . Time limit: You may calcuate the connect time using the procedure
  266.         DIFFTIME in toolbox #3.
  267.  
  268.       . ANSI graphics or full screen command: Toolbox #1 is a good start
  269.         for this attempt.
  270.  
  271.       If you need any assistance, you can contact Winfred Hu at the
  272.       Telemate support BBS's or the following network:
  273.  
  274.           SmartNet    Telemate conference
  275.           RelayNet    Telemate conference
  276.           FidoEcho    National Telemate Echo
  277.           CompuServe  [72070,3515]
  278.           InterNet    72070.3515@compuserve.com
  279.  
  280.  
  281.